Skip to main content

添加轮询触发器

在平台 UI 中，通过设置、输入设计器和 API 配置选项卡来设置您的轮询触发器。

先决条件​

1. 添加触发器设置​

  1. 在 Zapier 的平台 UI 中打开 Triggers（触发器）选项卡，然后选择 Add Trigger（添加触发器）。

  2. 在设置页面，指定以下内容：

    • Key：此触发器的唯一标识符，用于在 Zapier 内部引用。此项不会显示给用户。一旦保存，无法编辑。
    • Name：此触发器的用户友好名称，通常以形容词（如 New 或 Updated）开头，后跟触发器监视的应用程序中的项目名称。该名称使用标题大小写形式，会显示在 Zap 编辑器中以及 Zapier 应用目录的营销页面上。
    • Noun：一个描述此触发器监视内容的单个名词，Zapier 会使用它自动生成 Zap 中的文本。
    • Description：一个纯文本句子，用于描述触发器的工作原理以及何时使用。该描述会显示在 Zap 编辑器中以及 Zapier 应用目录的营销页面上。以短语 'Triggers when' 开头。
    • Visibility in Editor：一个选项，用于选择此触发器何时显示。默认选择 Shown（显示）。如果此触发器不应显示给用户，请选择 Hidden（隐藏）。通常在触发器尚未准备好用于集成时，或用于为动态下拉菜单提供支持的轮询触发器时，选择 Hidden。
    • Directions 仅用于静态 webhook，用于描述如何以及在何处复制-粘贴触发器的静态 webhook URL 到您的应用程序中。在其他情况下，Directions 不会显示给用户。公共集成中不允许使用静态 webhook（静态 Webhook）。

  3. 单击 Save and continue（保存并继续）按钮。

2. 完成输入设计器​

在 Input Designer（输入设计器）页面上，添加您的 API 所需的用户输入字段，以监视触发项。

触发器输入字段允许用户输入过滤器、标签和其他详细信息，以筛选端点中的新数据或更新数据。

如果此触发器的端点不需要任何输入数据，请继续。

3. 设置 API 配置​

平台 UI 默认选择 Polling trigger（轮询触发器）类型。

Platform UI vs CLI comparison

在 API Endpoint（API 端点）字段中输入您的 API URL。如果您的 API URL 在路径中需要特定数据，请在 URL 中输入以下文本，将 key 替换为在前一步中创建的相关输入字段的 key：

{{bundle.inputData.key}}

否则，Zapier 会自动将任何输入字段数据包含在 API 调用中，作为 URL 参数（针对 GET 请求），或在请求正文中作为 JSON（针对 POST 请求）。

如果您的 API 需要任何其他数据来返回新项目或更新项目（以预期响应类型的数组形式，按逆时间顺序排序），请使用 Show Options（显示选项）按钮来暴露更多详细的请求配置。或者，选择 Switch to Code Mode（切换到代码模式）来进一步使用 JavaScript 代码自定义 API 调用。

仅当您计划使用此触发器为其他 Zap 步骤中的动态下拉菜单提供支持（如查找用户、项目、文件夹和其他常用于创建新项目的应用程序数据），并且如果您的 API 调用可以分页数据，请选择 Support Paging（支持分页）（请参阅下拉菜单的更多详细信息）。

完成触发器设置后，单击 Save API Request & Continue（保存 API 请求并继续）。

4. 测试您的 API 请求​

配置测试数据来测试轮询触发器。

5. 定义您的输出​

按照指南定义样本数据和输出字段。